home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / boymks5e.zip / README.TXT < prev    next >
Text File  |  1991-12-16  |  20KB  |  456 lines
  1. BoyMks5E.zip - by Lee Breeden
  2.  
  3. This script is offered AS IS with all its flaws, as an example of the
  4. many different options available with BOYAN script language. There are no
  5. warranties, express or implied.  This is the efforts of my time, as well
  6. as others who have tried, tested, modified and corrected spelling <G> to
  7. make this what it is.
  8.  
  9. This idea was inspired by Kendall D'Andres, and help from Paul Buerkle.
  10.  
  11. The new scripts contain a new feature called SMART script, which will
  12. allow you to have inter-action with a remote system while the script is
  13. running and then return control back to the script.  It will also allow
  14. you to abort the script the script and allow it to RESUME where it left
  15. off......
  16.  
  17. New script has improved file transfers, supports BBSee15 for
  18. handling filenames using QWK newfiles.dat info.
  19.  
  20. Now supports RoseMail!
  21.  
  22. These are a few scripts that will make a system script that will set all of
  23. the variables necessary for calling a system for mail, and file functions.
  24.  
  25. It is self explanatory to generate the script, but there are some things
  26. that will need to be modified in your current boyan.mac file for all of
  27. this to work.
  28.  
  29. The files contained are:
  30.  
  31.  ° Readme.txt  -  this file
  32.  
  33.  ° Script.bsc  -  this contains all of the commands that will be used to
  34.                    run the system script.
  35.  
  36.  ° Makemail.bsc - is the file that you will need to run that makes the
  37.                    system script for you.
  38.  
  39.  ° Nite.bsc     - is a sample of my own script that I use to start calling
  40.                    all of the systems that I call.
  41.  
  42.  ° Boy.mac      - this is my own macro file that I use on my system. If
  43.                    you would like to look at it, I would suggest
  44.                    that you rename your own  boyan.mac file  and then ren
  45.                    boy.mac to boyan.mac and look at mine.
  46.                    If you do, you might need to make the following changes
  47.                    if you plan on trying to use it:
  48.                       a) modem init string. macro #9
  49.                       b) macro #1 has commands for call waiting.
  50.  
  51. Script LIST:
  52.  
  53.  °  end      bsc   This is a nice script that I run after disconnecting
  54.                    from a system (Macro #7), it displays the time and
  55.                    lenght of connection from the last call
  56.  
  57.  °  file     bsc   This is a boyan script file similar to list.
  58.  
  59.  °  gt       bsc   Logon script for GTComm boards
  60.  
  61.  °  hostset  bsc   Setup host script at specified time
  62.  
  63.  °  makemail bsc   MAIL Script generator
  64.  
  65.  °  modem    bsc   Modem setup script and checks MNP Settings
  66.  
  67.  °  nite     bsc   Sample unattended nite mail setup script
  68.  
  69.  °  opus     bsc   Logon script for Opus boards
  70.  
  71.  °  pcboard  bsc   Logon script for PCBoards
  72.  
  73.  °  qefiles  bsc   Filename grabber script.
  74.  
  75.  °  quote    bsc   Message quote macro
  76.  
  77.  °  rbbs     bsc   Logon script for RBBS boards
  78.  
  79.  °  script   bsc   Main script for mail calls
  80.  
  81.  °  start    bsc   Startup script for setting log file by date
  82.  
  83.  °  tcat     bsc   Logon script for TCat with Wildcat boards
  84.  
  85.  °  tcomm    bsc   Logon script for TComm boards
  86.  
  87.  °  timerlog bsc   Script for use with an answer machine to display time
  88.                    of call
  89.  
  90.  °  wildcat  bsc   Logon script for WildCat boards
  91.  
  92.  
  93. Purpose:
  94.  
  95.    This program is to aid anyone interested in calling systems unattended
  96. for mail and file transfers to PCBoard systems. All of this is will be
  97. done with Boyan scripts.  Even the process of creating a script will be
  98. done with a Boyan script.
  99.  
  100. Getting started:
  101.  
  102. First place all of the *.bsc files in the boyan script file directory.
  103. Next hit ALT-R and delete anything on the status line, followed by <CR>.
  104. Highlight the script called makemail.bsc and hit <cr>.
  105.  
  106.        You will need to have the following handy to complete the script.
  107.  
  108.          °  Name to call the script.
  109.          °  Type of door for mail.
  110.          °  Door number.
  111.          °  Name of system mail packets for both up and downloads.
  112.          °  The number of mail packets that you wish to keep.
  113.  
  114. The script called MailMake.bsc will check for your first and last name in
  115. macros #111 and #112. If not contained there, it will ask you for your
  116. first and last name. Then it will install them in 111 and 112 for you. The
  117. next time that you run MakeMail it will display your first and last name
  118. on the screen and ask if this is correct.
  119.  
  120. It will be displayed as Lee ` Breeden
  121.  
  122. the back quote character, one character after your first name MUST be
  123. there for all of this to work.
  124.  
  125. The script will then check to see if you have a defined password in the
  126. setup. If not it will ask you to install one. The rest of the script will
  127. be question and answer of the above questions. All of this information
  128. will be stored in your user defined script name.
  129.  
  130. Operation of the script.
  131.  
  132. Once you have created the User defined script, it will set all of the
  133. variables that will be needed for the call. All of the variables will be
  134. used in the script call SCRIPT.bsc. This way, if there are any changes in
  135. the mail door(s). A new script.bsc file can be easily replaced for the
  136. existing one without having to changes to the related commands for the
  137. system.bsc.
  138.  
  139. Here is what your system script should look like:
  140.  
  141. \\ This script automates Mail runs to EDSHOME Bulletin Board.
  142. \\ You must set the following macros with BOYAN's configuration module:    
  143. \\  \! = Macro # 111 = Your first name                                     
  144. \\  \@ = Macro # 112 = Your last name                                      
  145. \\  %PW = Is your defined password.                                      
  146. \\  \sv1 used for mail system report file *.rep.                           
  147. \\  \sv2 used for prodoor option number.                                   
  148. \\  \sv3 used for mail door option number.                                 
  149. \\  \sv4 used for mail packet system name *.qwk.                           
  150. \\  \sv5 used for up-file name or names.                                   
  151. \\  \sv6 used for file upload description.                                 
  152. \\  \sv7 used for file upload description, leave blank if not used         
  153. \\  \sv8 used for file upload description, leave blank if not used         
  154. \\  \sv9 used for file upload description, leave blank if not used         
  155. \\  \sv0 used for system name in call back option.                       
  156. \\  \svA used to set option for call back block.                           
  157. \\  \svB used for setting number of mail packets to keep.                  
  158. \\  \svC used for setting file scan option <U>pload <A>ll etc.             
  159. \\  \svD used internally to read variable        
  160. \\  \svE used internally for selection option                              
  161. \\  \svF used for setting cursor position in mail door.                   
  162. \\  \svG used for setting the maximun number of messages in mail door.     
  163. \\  \svH used for setting timer to wait for no messages prompt in mail door.
  164. \\ Need to have in boyan macro #7 \AT+[\qd]
  165. \\  as last command.                                                       
  166. \\Script assumes that you put your message replies in upload dir.           
  167. \\Script assumes that you put your messages packets in DN dir.             
  168. \\Script assumes that you use Zmodem configured as Z.                      
  169.                                                                            
  170. |LOGON                                    \\ Start script blocks    
  171. \IE+OFF,%LD[\LD+]                         \\ Turn on Log to disk file  
  172. \SV0[%SN]            \\ set existing system number to %v0
  173. \sv1[EdsHome.rep]    \\ Report packet name
  174. \SV2[1]              \\ enter door number [#]
  175. \sv4[EdsHome.qwk]    \\ Mail Packet name
  176. \SV5[boydoc50.zip ]  \\ Name of file to UpLoad
  177. \SV6[Great boyan script for viewing portions ]\\ file description
  178. \SV7[of the boyan 5.0 manual. Has menu and   ]\\ file description
  179. \SV8[table of contents.  By Paul Buerkle     ]\\ file description
  180. \SV9[          ]    \\ enter file name to download
  181. \SVB[9]             \\ enter number of qwk's to keep
  182. \SVC[a]             \\ scanning directories for files A all or U uploads
  183. \SVF[35]            \\ Cursor position
  184. \SVG[800]           \\ Maximum message counter for mail
  185. \SVH[1]             \\ Timer to wait for NO messages 2-15 sec
  186.                                                                            
  187. \DM[CONNECTED TO %SN]                     \\ System display message    
  188. \to[40]\pl                                \\ Set timer                 
  189. \\CA-[\eb]                                \\ Check carrier currently off
  190. \CA+[\SC[SCRIPT;NAME]]                    \\ Enter name block        
  191. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors          
  192. \CA+[\SC[SCRIPT;QUEST]]                   \\ Question block
  193. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors          
  194. \CA+[\SC[SCRIPT;mail]]                    \\ Mail block
  195. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors
  196. \CA+[\FE+%u:%V1[\SC[SCRIPT;QMul]]]        \\ Upload block
  197. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors
  198. \CA+[\SC[SCRIPT;QMdl]                     \\ Mail download
  199. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors
  200. \CA+[\SC[SCRIPT;FILES]]                   \\ Scan for new files block
  201. \\CA+[\FE+%U:%V5[\SC[SCRIPT;upload]]]     \\when doing upload or download remove
  202. \\CA+[\FE-%D:%V9[\SC[SCRIPT;download]]]   \\slash from beginning of line
  203. \CA-[\AB]\CA+[\gs[SCRIPT;Logoff]]         \\ Log off block
  204. \ab
  205.  
  206.  
  207. Extra Tips:
  208.  
  209.   I use a separate phone directory for calling systems at nite.  The
  210. reason being, is that the delete option in the phone directory can fowl up
  211. the order that the phone numbers are in, thus causing you some problems.
  212. You can use the clone fon option in the dialing directory to easily create
  213. a nite.fon file, and delete the entries that you don't use.
  214.  
  215. I have a path for the log files off of the boyan directory, called \log.
  216. There is also a file called start.bsc that is called from macro #9 that
  217. sets the current date of the log to disk file.  Each time the nite.bsc
  218. file runs it deletes one log file, keeping the last five of them.
  219.  
  220. If you run into any problems related to the doors or the script(s), I can
  221. be reached on any Boyan conference that you can find. I currently host the
  222. Boyan conference on the following nets: Rime, Ilink, SmartNet and U'NInet.
  223. Comments welcome.  I support the Boyan 5.0 program for Justin, and I
  224. answer the order line up until 10:00pm EST.  (301)805-7168  If you need
  225. help just yell..... not too loud... <g>.
  226.  
  227. If you are using one of these scripts and having some difficulties with
  228. one or any of them, please let me know.  I will be running the Boyan
  229. support line from 10pm(Nite) to 2am(morning) EST for the latest release.
  230. If you have any ideas, or suggestion, I would be happy to hear of them.
  231.  
  232.  
  233. New SMART script features:
  234.  
  235. This is something totally different from anything that I have done with
  236. the script language before.   These scripts will allow the user to leave
  237. the script running and have inter-action with the remote system.  When
  238. your thru you can resume the script where you left off.  Your even able to
  239. abort the script and have it restart at the last place (block) that you
  240. left off at........ IMPRESSIVE....hum.....
  241.  
  242. QUICK Start.  Install all of the files in the script directory.
  243.  
  244. I had to change the file that is called script.bsc.  It would be a good
  245. idea to MAKE A BACKUP copy of the SCRIPT.bsc just incase you have some
  246. problems with this script.   Run the MakeMail.bsc file.   The easiest way
  247. to do this is to hit Alt-R and highlight the file and then go thru the
  248. questions to create a script.
  249.  
  250.  
  251. Using the New features.
  252. You run the scripts in the same manor as before.  You will have a status
  253. line message that says "Hit <TAB> for Menu options" (see below).
  254.  
  255.  
  256. ╔═══════════════════════════════════════╗
  257. ║ OnLine MENU    %HR:%MI  %Mo/%DA/%YR   ║
  258. ╠═══════════════════════════════════════╣
  259. ║ <C> = find main Command               ║  ->   this command  was removed  from
  260. ║ <D> = Download a file                 ║       this menu but the command is
  261. ║ <DM>= Download Mail (from mail door)  ║       still active.
  262. ║ <E> = Edit Script                     ║
  263. ║ <F> = File Manager                    ║
  264. ║ <G> = Goodbye                         ║
  265. ║ <J> = Jump to DOS                     ║
  266. ║ <L> = Log to disk ...status %LD       ║
  267. ║ <M> = Mail (check for your mail)      ║
  268. ║ <N> = New File Scan                   ║
  269. ║ <O> = Open Door                       ║
  270. ║ <P> = edit Phone directory            ║
  271. ║ <Q> = Quick Note file                 ║
  272. ║ <R> = RESUME Script                   ║
  273. ║ <S> = Scroll-back buffer              ║
  274. ║ <T> = Terminal Mode                   ║
  275. ║ <U> = Upload a file                   ║
  276. ║ <UM>= Upload Mail (from mail door)    ║
  277. ╟───────────────────────────────────────╢
  278. ║ <R> = RESUME Script  <?> Manual Macro ║
  279. ║<Esc>= ABORT script   <V>iew Settings  ║
  280. ╚═══════════════════════════════════════╝
  281.  
  282. At this point you can choose anything on the menu <g>.....
  283. To start inter-active mode hit  "T"erminal mode.  At this point you can
  284. enter commands online with the remote, make changes, chat with sysop
  285. etc.... and then hit <TAB> and then "R"esume to start where you left off.
  286.  
  287. Whoops.....! hit the ESC button.... darn.... But guess what..... New
  288. SMART script feature will allow you to re-start the script and start where
  289. it left off as well......(look out Chuck.... resume too...!)
  290.  
  291. ReSTART script:
  292. To use this feature you need the start the script with this macro key
  293. configured somewhere to your liking.
  294.  
  295. \SC[%VY;Menu]
  296.  
  297. OPERATION
  298. Say your online and the script is scanning for new files, hit <TAB> and
  299. then <S>croll-back buffer to view files or what ever, hit ESC to get out
  300. of scroll back buffer and at the MENU hit "R" to resume where you were
  301. before.
  302.  
  303. MENU
  304. <C> = find main Command
  305. I removed this from the menu for space reasons but the command is active.
  306.  
  307.  <D> = Download a file
  308.  <DM>= Download Mail (from mail door)
  309. *<E> = Edit Script
  310. *<F> = File Manager
  311.  <G> = Goodbye
  312. *<J> = Jump to DOS
  313. *<L> = Log to disk ...status %LD
  314.  <M> = Mail (check for your mail)
  315.  <N> = New File Scan
  316.  <O> = Open Door
  317. *<P> = edit Phone directory
  318. *<Q> = Quick Note file
  319.  <R> = RESUME Script
  320. *<S> = Scroll-back buffer
  321.  <T> = Terminal Mode
  322.  <U> = Upload a file
  323.  <UM>= Upload Mail (from mail door)
  324.  
  325. * commands will return you to the menu
  326. Other commands will return you to the script/terminal mode
  327.  
  328. The commands on the menu will issue the block commands or line commands
  329. for NORMAL board operations...  I know that there are some sysops in there
  330. infinite wisdom who will insist that this command HAS to be.......  but
  331. they should work (95%) of the time
  332.  
  333. RESUME
  334. When using the resume command, it should work as long as the command to
  335. \eb (end the block) wasn't executed.  Smart script is a term that I am
  336. using for this operation.  What happens upon every completion of a block,
  337. it is flagged so that the script knows that the commands have already been
  338. completed.  So when you restart the script, it will start at the first
  339. block that was NOT completed.  This should work for all of the blocks
  340. except for the mail blocks.  Terminating within the door is fine, and
  341. resuming at the Command prompt is fine, but you can NOT reSTART the script
  342. in the process of getting mail.  The commands would reStart the download
  343. or the upload blocks of the script.
  344.  
  345. If a block has already been completed, the menu option for the command
  346. will call up the block and re-execute the commands again.
  347.  
  348. The View settings window allow you to see your settings, just some things
  349. else to play with.....
  350.  
  351. Manual Macro command is for anything that you might come up with.  You
  352. could use it to reset the \gv[] command while the script is running.
  353.  
  354.  
  355.     * * * *   File Transfers Uploading and downloading   * * * *
  356.  
  357. I have improved upon to interface for transferring files both uploading
  358. and downloading.  You can still do the file transfers exactly as before if
  359. you like, but I think that once you have tried the new approach that you
  360. will no longer have any interest in the older method.
  361.  
  362. This idea all started with Dan Potvin, who brought Martin Vallevand (author
  363. of BBSee in) with the idea of multi file downloading/uploading with the aid
  364. of BBSee.
  365.  
  366. File downloading:
  367.  
  368.    To download files, you need to create a file list that is the same name
  369. as the script that will be used in the dialing directory.  This file needs
  370. to reside in the script directory.  For downloading, the filename format
  371. can be either liner (80 characters max) or in a column format. IE:
  372.  
  373. edshome.dow   - download file name
  374. boyan5a.zip
  375. boyan5b.zip
  376. boydoc50.zip
  377. hostbbs2.zip
  378. boymk5d.zip
  379.  
  380. or
  381.  
  382. boyan5a.zip boyan5b.zip boydoc50.zip hostbbs2.zip boymk5d.zip
  383.  
  384. Once the files have been downloaded the file will be renamed, so that the
  385. next time that you call the system it will not attempt to repeat the
  386. process, or if there is a problem you will still have your list.
  387.  
  388. All of the above can also be done with BBSee, using the file tag option.
  389. This will make the file and place all of the filenames in it.
  390.  
  391. File Uploading.
  392.  
  393. File uploading is just as simple, only you have some guidelines to follow.
  394. For a single file upload follow this format.
  395.  
  396. edshome.up
  397. first  line :filename
  398. second line : description one   (42 characters max)
  399. third  line : description two   (42 characters max)
  400. fourth line : description three (42 characters max) only three lines!
  401.  
  402. For more than one upload, follow this format
  403.  
  404. first  line :filename
  405. second line : description one   (42 characters max)
  406. third  line : description two   (42 characters max)
  407. fourth line : description three (42 characters max) only three lines!
  408. +    Must contain a plus for additional uploads
  409.  
  410. IE: Sample
  411.  
  412. scsidiag.zip
  413. Diagnostics utility for SCSI hard drives
  414. +
  415. fondir57.zip
  416. Phone convert program, supports most
  417. current comm programs.
  418. +
  419. scout54.zip
  420. Scout 5.4 file manager TRS with Hot Key
  421. +
  422. HYDK430.ZIP
  423. Hyperdisk v4.30 Disk Cache
  424. +
  425. LIST76E.ZIP
  426. LIST version 7.6E
  427. +
  428. SCANV85.ZIP
  429. The latest update in the McAfee's series of
  430. virus detection.
  431. +
  432. CLEAN85.ZIP
  433. Clean85.zip  to go along with scan 85
  434.  
  435. Notes:
  436.  
  437. I used the \GV[] macro command in the script.bsc.  PLEASE realize this
  438. concept!  If you call a system and abort the script, the \GV command opens
  439. a file.  The file stays open until the command is called to close it or
  440. that a new \gv[] command is executed.  If you abort the script and try a
  441. again, when the next \GV command is called, it will grab the next filename
  442. and description.  If see the wrong filename being shown on the remote
  443. systems end THIS IS WHY.  You can correct the problem by issuing the
  444. manual macro command Alt-M and enter \gv[].
  445.  
  446.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  447. Please HELP OUT.  If you are using these scripts and are having problems
  448. with them, I would like to know about them.  I try to make these so that
  449. they will work on every system (sysop) who gets in our way..... <g>.
  450. I can be reached in any Boyan conference that you can find.  I can be
  451. FAXed as (301)805-7168 from voice mail hit 22#.
  452.  
  453.  Lee Breeden
  454.  
  455.   ■ On Monday ■ December 16, 1991 ■ at 11:40 pm ■ from Bowie Md ■
  456.